home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / amiga / opalvisn / tbsvw015.lha / TBSView.doc < prev    next >
Encoding:
Text File  |  1993-02-14  |  6.7 KB  |  190 lines
  1.                                TBSView v0.15
  2.                       Written by The Burning Stickmen
  3.                       Release Date: January 31, 1993
  4.  
  5.  
  6. Copyright
  7. ~~~~~~~~~
  8.     TBSView, (c) Copyright 1992 The Burning Stickmen.  All rights reserved.
  9. TBSView   is   freeware,  so  no  financial  donations  are  required  (but
  10. nonetheless appreciated).  TBSView may be freely distributed as long as all
  11. documentation and the executable remain unchanged and are included with the
  12. distribution.   Commercial  distribution  is  not  allowed  without written
  13. permission from The Burning Stickmen.
  14.  
  15.  
  16. Description
  17. ~~~~~~~~~~~
  18.     TBSView is a GIF viewer for use with the OpalVision graphics card.
  19. TBSView currently only handles GIF87a format GIF's.
  20.  
  21.  
  22. Use
  23. ~~~
  24.     TBSView is currently only usable from a CLI/shell.  The parameters for
  25. TBSView follow the AmigaDOS 2.0 standard.  The argument template for
  26. TBSView looks like this:
  27.  
  28.     FILES/M,NODELAY/S,HOLDLAST/S,NAMES=FILENAMES/S,VERBOSE/S,LORES/S,NOLACE/S,
  29.     LTIMEPICS/S,LATCH=LATCHDISPLAY/S,SINGLE=SINGLEDISPLAY/S,DUAL=DUALDISPLAY/S,
  30.     AMP=AMIGAPRIORITY/S,OVP=OVPRIORITY/S,RESET=RESETOPAL/S,NOVIEW/S,
  31.     ERROR=EXTENDEDERROR/S
  32.  
  33. Here is a short explanation of each argument:
  34.  
  35.     FILES/M
  36.         An unlimited number of filenames and file patterns can be specified
  37.         either  as  FILE=<filespec>  or by just including <filespec> in the
  38.         command line.  Any arguments that are not used by other options are
  39.         automatically considered to be filespecs.
  40.  
  41.     NODELAY/S
  42.         When  enabled,  TBSView  will  show the images one after another as
  43.         fast as it is capable.
  44.  
  45.     HOLDLAST/S
  46.         This  option  is  only useful when NODELAY has been enabled.  Since
  47.         the  last  image would be displayed for only a flash before TBSView
  48.         was  finished  with  NODELAY  enabled, this flag will hold the last
  49.         image in the same way that images are held without NODELAY.
  50.  
  51.     NAMES=FILENAMES/S
  52.         This  option  will  print  out  the filename of each image as it is
  53.         viewed.
  54.  
  55.     VERBOSE/S
  56.         When  enabled,  extensive  information  about  each  image  will be
  57.         printed  out along with each image, including the image size, name,
  58.         etc.
  59.  
  60.     LORES/S
  61.         Forces the OpalVision display to use a lo-res screen.
  62.  
  63.     NOLACE/S
  64.         Forces the OpalVision display to use a non-interlaced screen.
  65.  
  66.     TIMEPICS/S
  67.         This  will  make  TBSView time the decoding process for each image,
  68.         and output the results to the CLI/shell.
  69.  
  70.     LATCH=LATCHDISPLAY/S
  71.         TBSView  will  keep  the last image loaded into the OpalVision, and
  72.         overlay  Amiga  graphics.   This  enables  a  GIF to be loaded as a
  73.         backdrop  for your regular Amiga graphics (the backdrop will remain
  74.         until another program wants to make use of the OpalVision).
  75.  
  76.     SINGLE=SINGLEDISPLAY/S
  77.         TBSView  will  make have only Amiga or OpalVision graphics visible,
  78.         not both.  This is the default view mode.
  79.  
  80.     DUAL=DUALDISPLAY/S
  81.         Creates  an  overlay  effect,  which places the OpalVision graphics
  82.         behind  Amiga  graphics.   The priority of the OpalVision and Amiga
  83.         graphics can be changed with the AMIGAPRIORITY/OVPRIORITY flags.
  84.  
  85.     AMP=AMIGAPRIORITY/S        
  86.     OVP=OVPRIORITY/S
  87.         These two flags determine whether Amiga graphics have priority over
  88.         OpalVision graphics, or vice-versa.  TBSView defaults to having the
  89.         OpalVision  graphics  having  priority over Amiga graphics.  If you
  90.         specifiy  both  flags,  TBSView will leave OpalVision graphics with
  91.         priority over Amiga graphics.
  92.  
  93.     RESET=RESETOPAL/S
  94.         This causes the internal state of the OpalVision to be reset.  This
  95.         includes  clearing  any  backdrop images and leaving the display as
  96.         the Amiga graphics only.
  97.  
  98.     NOVIEW/S
  99.         This flag results in no decoding of GIF's, as well as no display of
  100.         GIF's.  This can be handy when using VERBOSE to scan image stats.
  101.  
  102.     ERROR=EXTENDEDERROR/S
  103.         Causes  more extensive error messages to be displayed when an image
  104.         fails to load.
  105.  
  106.  
  107. During the viewing of images, the following input events are monitored:
  108.  
  109.     Keyboard "s" or "S":
  110.         Switches  the  display  into  a single-display mode.  If OpalVision
  111.         graphics have priority over Amiga graphics, then the result will be
  112.         only  OpalVision  graphics.   If  Amiga graphics have priority, the
  113.         opposite will happen.
  114.  
  115.     Keyboard "d" or "D":
  116.         Switches  the  display  into  dual-display mode, similar to using a
  117.         genlock to superimpose graphics over video.  If OpalVision graphics
  118.         have  priority  over  Amiga  graphics,  then the result will be the
  119.         OpalVision  graphics  showing  everywhere  except where colour zero
  120.         occurs  in  the  OpalVision  graphics, in which case Amiga graphics
  121.         will  be  shown.   If  Amiga  graphics  have priority, the opposite
  122.         effect will occur.
  123.  
  124.     Keyboard "a" or "A":
  125.         Gives Amiga graphics priority over OpalVision graphics.
  126.  
  127.     Keyboard "o" or "O":
  128.         Gives OpalVision graphics priority over Amiga graphics.
  129.  
  130.     Keyboard "q","Q" or ESC:
  131.         Quits TBSView.
  132.  
  133.     Keyboard <space>,<return>, or the right or middle mouse-button:
  134.         Advances to the next image (or quits if on the last image).
  135.  
  136.  
  137. Examples:
  138.  
  139.     TBSView #?gif
  140.  
  141.     - this  would view all GIF's in the current directory, pausing between
  142.     each  GIF  for keyboard input.  The display would default to OpalVision
  143.     graphics visible without dual-display mode.
  144.  
  145.     TBSView Test.gif dh1:Pics/GIFS/#? NODELAY HOLDLAST
  146.  
  147.     - this  would  view Test.gif and all GIF's in the dh1:pics/GIFS drawer
  148.     with  minimal  time between each GIF.  The last GIF would be held until
  149.     TBSView is quit by a space, enter or mouse-button click.
  150.  
  151.  
  152. Requirements
  153. ~~~~~~~~~~~~
  154.     To use TBSView, you must have:
  155.         1. An OpalVision graphics card.
  156.         2. AmigaDOS Release 2 (Kickstart & Workbench 2.0) or greater.
  157.  
  158.  
  159. Future Enhancements
  160. ~~~~~~~~~~~~~~~~~~~
  161.     - support for IFF and JPEG images
  162.     - faster GIF loader
  163.     - scrolling for super-bitmap images
  164.     - workbench version, including:
  165.         - invocation with selected icons
  166.         - 'drop box' icon to view images with
  167.         - TOOLTYPES support
  168.  
  169.  
  170. Problems/Bugs
  171. ~~~~~~~~~~~~~
  172.     None known.
  173.  
  174.  
  175. Support
  176. ~~~~~~~
  177.     If  you  encounter  any problems with TBSView, please let us know!  Our
  178. support  BBS  is  The  Cloning  Machine  BBS  (519)  749-2691.  To report a
  179. problem,  just  leave E-Mail to "The Burning Stickmen".  Please include the
  180. program  name  and  version, as well as a report of the problem, and how to
  181. reproduce  it.   A  listing  of  your  system  configuration  would also be
  182. helpful,  as well as any other software that you run in the background with
  183. the program (Commodities, etc.).
  184.     New  updates  will also be available on The Cloning Machine, along with
  185. other  utilities  produced by The Burning Stickmen.  The Cloning Machine is
  186. run  on  a  US Robotics Dual Standard, and is 14.4K HST, and 9600 v.32, has
  187. 330 megs of hard drive space, and a CD-ROM drive is also on-line.
  188.     Also, any problems/suggestions/bug reports can be mailed to "The
  189. Burning Stickmen" on the OpalVision support BBS.
  190.